As devidas referências

• Webinário do RStudio, Introducing to bookdown por Yihui Xie. https://www.rstudio.com/resources/webinars/introducing-bookdown/

• Livro bookdown: Authoring Books with R Markdown, escrito por Yihui Xie utilizando o bookdown. https://bookdown.org/yihui/bookdown

• Repositórios bookdown-demo (demostração) e bookdown (desenvolvimento) do pacote.

O que é o bookdown

Um pacote R que estende as funcionalidades do rmarkdown para escrita simples de livros e artigos longos.

• Mantém as funcionalidades do rmarkdown (sintaxe simples, vários formatos de saída, opções de chunk, etc.);

• Adiciona a possibilidade de múltiplas páginas html com referência cruzada para tabelas, figuras, equações, etc.;

• Inclui um estilo de saída GitBook, formato elegante de livros html

Fazendo você se impressionar com uma simples ferramenta.

Porque o bookdown?

Usar Word?

Um parágrafo ok, dois pode ser, mais de dois …

Latex?

Muito melhor, mas quando precisar alterar algo em uma tabela por exemplo …

Markdown?

Simples e portável !!!

Bookdown!

Mecla a facilidade e portabilidade do Markdown com a elegância de outputs em LaTeX e HTMLs

Alguns exemplos

Página inicial do bookdown https://bookdown.org/.

Como começar

Requisitos

Para elaborar um livro.

1. Software R;
2. Editor de arquivos rmarkdown - .Rmd (emacs, RStudio, etc.);
3. Pacote bookdown;
4. Uma distribuição Latex, caso queira resultados em PDF.

Requisitos

Para publicar no GitHub Pages.

1. Instalação do Git;
2. Uma conta no GitHub.

Formatos bookdown

Em arquivos .Rmd comuns adicione os outputs.

---
output:
  bookdown::gitbook: default
  bookdown::pdf_book: default
  bookdown::epub_book: default
---

Estrutura de um livro

Para elaboração de livros costuma-se dividir os capítulos em arquivos.

.
├── _bookdown.yml
├── cap01.Rmd
├── cap02.Rmd
├── cap03.Rmd
├── cap04.Rmd
├── cap05.Rmd
├── cap06.Rmd
├── index.Rmd
└── _output.yaml

Estrutura de um livro

O conteúdo do arquivo _bookdown.yaml:

book_filename: "bookdown-demo"
chapter_name: "Capítulo "

O conteúdo do arquivo _output.yaml:

bookdown::gitbook: default
bookdown::pdf_book: default
bookdown::epub_book: default

Elementos de um documento

Imagens:

knitr::include_graphics("images/imagem")

Elementos de um documento

Referência cruzada:

(\#key) -> \label{key}
\@ref(key) -> \ref{key}

Elementos de um documento

Citações (bibtex):

@LEG2016   -> \citet{LEG2016} -> "Leg (2016)"
[@LEG2016] -> \citep{LEG2016} -> "(Leg, 2016)"

Exemplos pessoais

• Shiny: Aplicações web com R
  http://jreduardo.github.io/bookdown-demo/
  http://github.com/JrEduardo/bookdown-demo/

• Regression Models for Count Data
  http://cursos.leg.ufpr.br/rmcd/
  http://github.com/leg-ufpr/rmcd/

Publicando seus livros

Servidores

Utilizando o GitHub Pages